Functions
CRONO_Return	CRONO_GetDeviceCount (CRONO_H crono, int *count)

CRONO_Return	CRONO_GetDeviceSerial (CRONO_H crono, int deviceIndex, char *buf)

CRONO_Return	CRONO_OpenDeviceBySerial (CRONO_H crono, char *serial)

CRONO_Return	CRONO_GetDeviceInfo (CRONO_H crono, char serial, CRONO_DeviceInfo deviceInfo)

CRONO_Return	CRONO_OpenDeviceAsDataConverter (CRONO_H crono, char *rawFilePath)

Detailed Description

Functions to find and access connected Crono devices.

Function Documentation

◆ CRONO_GetDeviceCount()

CRONO_Return CRONO_GetDeviceCount	(	CRONO_H	crono,
		int *	count
	)

Gets the count of all active and connected Crono devices.

Devices already open and busy are not regarded as available and therefore not counted.

Parameters

crono	Handle to an existing Crono object.
count	Pointer to an int to contain the count value

Returns: CRONO_Return

Examples: CRONO_SDK_Example.c.

◆ CRONO_GetDeviceInfo()

CRONO_Return CRONO_GetDeviceInfo	(	CRONO_H	crono,
		char *	serial,
		CRONO_DeviceInfo *	deviceInfo
	)

Gets information about a device with a given serial number, or of the already open device.

Parameters

crono	Handle to an existing Crono object.
serial	Serial number of the Crono device. Can be an empty string if the device is already opened.
deviceInfo	Struct containing information about the requested device, passed by reference.

Returns: CRONO_Return

Examples: CRONO_SDK_Example.c.

◆ CRONO_GetDeviceSerial()

CRONO_Return CRONO_GetDeviceSerial	(	CRONO_H	crono,
		int	deviceIndex,
		char *	buf
	)

Get the serial number of a connected Crono device given its numeric index.

Parameters

crono	Handle to an existing Crono object.
deviceIndex	Zero-based index of Crono device. The valid range is 0 to (number of devices) - 1
buf	Pointer to a char buffer to contain the serial number. The buffer must be at least MAX_SERIAL_LENGTH characters long. The written serial number string is null-terminated.

Returns: CRONO_Return

Examples: CRONO_SDK_Example.c.

◆ CRONO_OpenDeviceAsDataConverter()

CRONO_Return CRONO_OpenDeviceAsDataConverter	(	CRONO_H	crono,
		char *	rawFilePath
	)

Open saved Crono raw file as a virtual device for data conversion.

A virtual device can be controlled as a real one, except for any device setting (all incompatible functions will return an error when a virtual device is open). In order to perform a conversion, first call the CRONO_GetAcquisitionInfo and CRONO_GetCameraSettings to retrieve the actual acquisition info and settings. Then the desired formats must be chosen using CRONO_ConfigAcquisition() function, finally a virtual acquisition is started using CRONO_StartAcquisition() and data is retrieved using CRONO_GetHistogramData() or CRONO_GetFramesData() or CRONO_GetTimeTagsData(). It is suggest to use the function CRONO_GetAcquisitionStatus() to monitor the status of the internal buffers. When convertion is done, function must be called CRONO_StopAcquisition(). See the SDK_Example for more details.

Parameters

crono	Handle to an existing Crono object.
rawFilePath	Char array with the full path to an existing Crono raw data file.

Returns: CRONO_Return

Examples: CRONO_SDK_Example.c.

◆ CRONO_OpenDeviceBySerial()

CRONO_Return CRONO_OpenDeviceBySerial	(	CRONO_H	crono,
		char *	serial
	)

Opens a device with a given serial number.

Parameters

crono	Handle to an existing Crono object.
serial	Serial number of the Crono device to be opened.

Returns: CRONO_Return

Examples: CRONO_SDK_Example.c.